home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra / helpful.zip / uucp < prev    next >
Text File  |  1995-08-21  |  20KB  |  599 lines
  1.   The Linux UUCP HOWTO
  2.   Vince Skahan, <vince@halcyon.com>
  3.   v1.12, 31 March 1995
  4.  
  5.   This document describes the setup and care+feeding of UUCP under
  6.   Linux.  You need to read this if you plan to connect to remote sites
  7.   via UUCP via a modem, via a direct-connection, or via Internet.  You
  8.   probably do *not* need to read this document if don't talk UUCP.
  9.  
  10.   1.  Introduction
  11.  
  12.   The intent of this document is to answer some of the questions and
  13.   comments that appear to meet the definition of "frequently asked
  14.   questions" about UUCP software under Linux in general, and the version
  15.   in the Linux SLS and Slackware distributions in particular.
  16.  
  17.   This document and the corresponding Mail and News "HOWTO" documents
  18.   collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously been
  19.   posted to comp.os.linux.announce.
  20.  
  21.   1.1.  New versions of this document
  22.  
  23.   New versions of this document will be periodically posted to
  24.   comp.os.linux.announce, comp.answers, and news.answers.  They will
  25.   also be added to the various anonymous ftp sites who archive such
  26.   information including sunsite.unc.edu:/pub/Linux/docs/HOWTO.
  27.  
  28.   In addition, you should be generally able to find this document on the
  29.   Linux WorldWideWeb home page at http://sunsite.unc.edu/mdw/linux.html.
  30.  
  31.  
  32.   1.2.  Feedback
  33.  
  34.   I am interested in any feedback, positive or negative, regarding the
  35.   content of this document via e-mail.  Definitely contact me if you
  36.   find errors or obvious omissions.
  37.  
  38.   I read, but do not necessarily respond to, all e-mail I receive.
  39.   Requests for enhancements will be considered and acted upon based on
  40.   that day's combination of available time, merit of the request, and
  41.   daily blood pressure :-)
  42.  
  43.   Flames will quietly go to /dev/null so don't bother.
  44.  
  45.   In particular, the Linux filesystem standard for pathnames is an
  46.   evolving thing.  What's in this document is there for illustration
  47.   only based on the current standard at the time that part of the
  48.   document was written and in the paths used in the distributions or
  49.   'kits' I've personally seen.  Please consult your particular Linux
  50.   distribution(s) for the paths they use.
  51.  
  52.   Feedback concerning the actual format of the document should go to the
  53.   HOWTO coordinator - Greg Hankins (gregh@sunsite.unc.edu).
  54.  
  55.  
  56.   1.3.  Copyright Information
  57.  
  58.   The UUCP-HOWTO is copyrighted (c)1994 Vince Skahan.
  59.  
  60.   A verbatim copy may be reproduced or distributed in any medium
  61.   physical or electronic without permission of the author.  Translations
  62.   are similarly permitted without express permission if it includes a
  63.   notice on who translated it.
  64.  
  65.   Short quotes may be used without prior consent by the author.
  66.   Derivative work and partial distributions of the UUCP-HOWTO must be
  67.   accompanied with either a verbatim copy of this file or a pointer to
  68.   the verbatim copy.
  69.  
  70.   Commercial redistribution is allowed and encouraged; however, the
  71.   author would like to be notified of any such distributions.
  72.  
  73.   In short, we wish to promote dissemination of this information through
  74.   as many channels as possible. However, we do wish to retain copyright
  75.   the HOWTO documents, and would like to be notified of any plans to
  76.   redistribute the HOWTOs.
  77.  
  78.   We further want that ALL information provided in the HOWTOS is
  79.   disseminated.  If you have questions, please contact Greg Hankins, the
  80.   Linux HOWTO coordinator, at gregh@sunsite.unc.edu, or +1 404 853 9989.
  81.  
  82.  
  83.   1.4.  Standard Disclaimer
  84.  
  85.   Of course, I disavow any potential liability for the contents of this
  86.   document.  Use of the concepts, examples, and/or other content of this
  87.   document is entirely at your own risk.
  88.  
  89.  
  90.   1.5.  Other sources of information
  91.  
  92.   1.5.1.  Linux HOWTO Documents
  93.  
  94.   There is plenty of exceptional material provided in the other Linux
  95.   HOWTO documents and from the Linux DOC project.  In particular, you
  96.   might want to take a look at the following:
  97.  
  98.  
  99.   o  the Serial Communications HOWTO
  100.  
  101.   o  the Ethernet HOWTO
  102.  
  103.   o  the Linux Networking Administrators' Guide
  104.  
  105.  
  106.   1.5.2.  USENET
  107.  
  108.   comp.mail.uucp can answer most of your UUCP questions
  109.  
  110.   1.5.3.  Mailing Lists
  111.  
  112.   There is a Taylor UUCP mailing list.
  113.  
  114.   To join (or get off) the list, send mail to
  115.  
  116.                 taylor-uucp-request@gnu.ai.mit.edu
  117.  
  118.  
  119.  
  120.   This request goes to a person, not to a program, so please make sure
  121.   that you include the address at which you want to receive mail in the
  122.   text of the message.
  123.  
  124.   To send a message to the list, send it to
  125.  
  126.                taylor-uucp@gnu.ai.mit.edu
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.   1.5.4.  Books
  134.  
  135.   HDB and V2 versions of UUCP are documented in about every vendor's
  136.   documentation as well as in almost all *nix communications books.
  137.  
  138.   Taylor config files are currently only documented in the info files
  139.   provided with the sources (and in the SLS distribution hopefully).  To
  140.   read them, you can grab the nice "infosrc" program from the SLS "s"
  141.   disks and compile it.
  142.  
  143.   The following is a non-inclusive set of books that will help.
  144.  
  145.   o  "Managing UUCP and USENET" from O'Reilly and Associates is in my
  146.      opinion the best book out there for figuring out the programs and
  147.      protocols involved in being a USENET site.
  148.  
  149.   o  "Unix Communications" from The Waite Group contains a nice
  150.      description of all the pieces (and more) and how they fit together.
  151.  
  152.   o  "Practical Unix Security" from O'Reilly and Associates has a nice
  153.      discussion of how to secure UUCP in general.
  154.  
  155.   o  "The Internet Complete Reference" from Osborne is a fine reference
  156.      book that explains the various services available on Internet and
  157.      is a great source for information on news, mail, and various other
  158.      Internet resources.
  159.  
  160.   o  "The Linux Networking Administrators' Guide" from Olaf Kirch of the
  161.      Linux DOC Project is available on the net and is also published by
  162.      (at least) O'Reilly and SSC.  It makes a fine one-stop shopping to
  163.      learn about everything you ever imagined you'd need to know about
  164.      Unix networking.
  165.  
  166.  
  167.   1.6.  Where *NOT* to look for help
  168.  
  169.   There is nothing "special" about configuring and running UUCP under
  170.   Linux (any more).  Accordingly, you almost certainly do *NOT* want to
  171.   be posting generic UUCP-related questions to the comp.os.linux.*
  172.   newsgroups.
  173.  
  174.   Unless your posting is truly Linux-specific (ie, "please tell me what
  175.   config file support is built into the binaries for Taylor uucp v1.04
  176.   in SLS v1.02"), you should be asking your questions in comp.mail.uucp
  177.   or on the Taylor UUCP mailing list as indicated above.
  178.  
  179.   Let me repeat that.
  180.  
  181.   There is virtually no reason to post anything uucp-related in the
  182.   comp.os.linux hierarchy any more.  There are existing newsgroups in
  183.   the comp.mail.* hierarchy to handle *ALL* your questions.
  184.  
  185.   IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC QUESTIONS, YOU
  186.   ARE LOOKING IN THE WRONG PLACE FOR HELP.  THE UUCP EXPERTS HANG OUT IN
  187.   THE PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  188.  
  189.   POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES
  190.   YOUR TIME AND EVERYONE ELSE'S AND IT FREQUENTLY DELAYS YOU FROM
  191.   GETTING THE ANSWER TO YOUR QUESTION.
  192.  
  193.  
  194.   2.  Hardware Requirements
  195.  
  196.  
  197.   There are no specific hardware requirements for UUCP under Linux.
  198.   Basically any Hayes-compatible modem works painlessly with UUCP.
  199.   In most cases, you'll want the fastest modem you can afford.  In
  200.   general, you want to have a 16550 UART on your serial board or built
  201.   into your modem to handle speeds of above 9600 baud.
  202.  
  203.   If you don't know what that last sentence means, please consult the
  204.   comp.dcom.modems group or the various fine modem and serial
  205.   communications FAQs and periodic postings on USENET.
  206.  
  207.  
  208.   3.  Getting UUCP
  209.  
  210.   Taylor UUCP (current version 1.05) is available on prep.ai.mit.edu in
  211.   source form and in various Linux distributions in binary form.
  212.  
  213.   The newspak-2.4.tar.z distribution contains config files and readme
  214.   files related to building uucp, news, and mail software under Linux
  215.   from the various freely-available sources.  It can usually be found on
  216.   sunsite.unc.edu in the directory /pub/Linux/system/Mail/news.  If you
  217.   can't find it on sunsite, please send me mail and I'll make sure you
  218.   get a copy of it.
  219.  
  220.  
  221.   4.  Installing the Software
  222.  
  223.   (Much of this section is taken verbatim from the README file in the
  224.   Taylor UUCP v1.05 sources - it's provided here so I can help you
  225.   "rtfm" instead of just telling you to do so)
  226.  
  227.   Detailed compilation instructions are in uucp.texi in the sources.
  228.  
  229.   You can grab "known good" conf.h and policy.h files for Linux from the
  230.   newspak distribution referred to in the "other sources of information"
  231.   section above.  In that case, you can probably go right to typing
  232.   "make".
  233.  
  234.  
  235.   4.1.  Extracting the compressed sources
  236.  
  237.   To extract a gzip'd tar archive, I do the following:
  238.  
  239.                   gunzip -c filename.tar.z | tar xvf -
  240.  
  241.  
  242.   A "modern" tar can just do a:
  243.  
  244.                  tar -zxvf filename.tgz
  245.  
  246.  
  247.  
  248.   4.2.  Edit Makefile.in to set installation directories.
  249.  
  250.   Here, I set "prefix" to "/usr" rather than the default of "/usr/local"
  251.  
  252.  
  253.   4.3.  Run "configure"
  254.  
  255.   Type "sh configure".
  256.  
  257.   The configure script will compile a number of test programs to see
  258.   what is available on your system and will calculate many things.
  259.  
  260.   The configure script will create conf.h from conf.h.in and Makefile
  261.   from Makefile.in.  It will also create config.status, which is a shell
  262.   script which actually creates the files.
  263.  
  264.  
  265.   o  Rather than editing the Makefile.in file in the sources as
  266.      indicated above, you can get the same effect by:
  267.  
  268.              "configure --prefix=/usr/lib"
  269.  
  270.  
  271.  
  272.   4.4.  Configure the future setup of the software
  273.  
  274.  
  275.   4.4.1.  Examine conf.h and Makefile to make sure they're right.
  276.  
  277.   I took the defaults
  278.  
  279.   4.4.2.  Edit policy.h for your local system.
  280.  
  281.  
  282.   o  - set the type of lockfiles you want (HAVE_HDB_LOCKFILES)
  283.  
  284.   o  - set the type of config files you want built in
  285.      (HAVE_TAYLOR_CONFIG, HAVE_V2_CONFIG, HAVE_HDB_CONFIG)
  286.  
  287.   o  - set the type of spool directory structure you want (SPOOLDIR_HDB)
  288.  
  289.   o  - set the type of logging you want (HAVE_HDB_LOGGING)
  290.  
  291.   o  - set the default search path for commands (I added /usr/local/bin
  292.      to mine)
  293.  
  294.   4.5.  Compile and install the software
  295.  
  296.  
  297.   o  Type "make".
  298.  
  299.   o  Use "uuchk | more" to check configuration files.  You can use
  300.      "uuconv" to convert between configuration file formats.
  301.  
  302.   o  Type "make install" to install.
  303.  
  304.   4.6.  Set up the config files
  305.  
  306.   I'd recommend you start by taking the attached known-good config files
  307.   for HDB mode and installing them.
  308.  
  309.   o  Make sure that the Permissions file indicates exactly where rmail
  310.      and rnews are to be found if you put them anywhere other than in
  311.      the path you specified in policy.h
  312.  
  313.   o  Make sure that your Devices files matches the actual location of
  314.      your modem (cua1=COM2 in the examples)
  315.  
  316.   o  Edit the Systems file to set up the system(s) you talk to with
  317.      their speed, phone number, username, and password.
  318.  
  319.      *PROTECT THIS FILE AGAINST WORLD READ*
  320.  
  321.   o  Set up the Permissions file and add a set of lines for each site
  322.      you talk to.  For security reasons, it's recommended to make sure
  323.      they each have a separate account (if you allow dialin) and home
  324.      directory so you can track things.
  325.  
  326.  
  327.   4.7.  Give it a try
  328.  
  329.  
  330.  
  331.           /usr/lib/uucp/uucico -r 1 -x 9 -s remote_system_name
  332.  
  333.  
  334.  
  335.   The -x 9 will have maximum debugging information written to the
  336.   /usr/spool/uucp/.Admin/audit.local file for help in initial setup.
  337.  
  338.   I normally run -x 4 here since that level logs details that help me
  339.   with login problems.  Obviously, this contains cleartext information
  340.   from your Systems file (account/password) so protect it against world-
  341.   read.
  342.  
  343.  
  344.   o  from Pierre.Beyssac@emeraude.syseca.fr
  345.  
  346.      Taylor has more logging levels.  Use -x all to get the highest
  347.      level possible.
  348.  
  349.      Also, do a "tail -f /usr/spool/uucp/.Admin/audit.local" while
  350.      debugging to watch things happen on the fly.
  351.  
  352.   4.8.  It doesn't work - now what ?
  353.  
  354.   In general, you can refer to the documentation mentioned above if
  355.   things don't work.  You can also refer to your more experienced UUCP
  356.   neighbors for help.  Usually, it's something like a typo anyway.
  357.  
  358.  
  359.   5.  Frequently Asked Questions about Linux UUCP
  360.  
  361.  
  362.  
  363.   5.1.  Why is my binary of uucp configured in HDB rather than "Taylor"
  364.   mode?
  365.  
  366.   (religious mode on - I know some people are just as religious about
  367.   "ease of use" as I am about "being standard".  That's why they make
  368.   source code you can build your own from :-) )
  369.  
  370.   Because IMHO it's the de-facto standard UUCP implementation at this
  371.   time.  There are thousands of sites with experienced admins and there
  372.   are many places you can get incredibly good information concerning the
  373.   HDB setup.
  374.  
  375.   The uucp-1.04 that's in SLS 1.02 and later has all three modes of
  376.   config files built in.  While I can't test it, I did "rtfm" and Ian
  377.   Taylor tells me that it should work.
  378.  
  379.   The search order for config files is Taylor then V2 (L.sys)  then HDB.
  380.   Use the uuconv utility in /usr/lib/uucp to convert config files from
  381.   one mode to another.
  382.  
  383.   If you can't wait, grab the sources for uucp and specify
  384.   HAVE_BNU_CONFIG, HAVE_V2_CONFIG *and* HAVE_TAYLOR_CONFIG in the
  385.   policy.h file and type "make".
  386.  
  387.   The following workaround is ugly, but it does work, if you want to run
  388.   Taylor configs from binaries that don't have it built in.
  389.  
  390.   o  From mbravo@tctube.spb.su (Michael E. Bravo)
  391.  
  392.      - add  "-I /usr/local/lib/uucp/config" to _every_ invocation of
  393.      whatever program in uucp package
  394.  
  395.   Also, the current Slackware has a nice setup where they separated the
  396.   config files for the various configurations into separate directories.
  397.   For example, the HDB config files would go into
  398.   /usr/lib/uucp/hdb_config.  While I used to 'roll my own' here, I've
  399.   been running the out-of-the-box Slackware UUCP in HDB mode here with
  400.   no problems for quite a while.
  401.  
  402.  
  403.   5.2.  Why do I get "timeout" on connections when I upgraded to
  404.   uucp-1.04 ?
  405.  
  406.  
  407.   o  from Ed Carp - erc@apple.com
  408.  
  409.      If you use a "Direct" device in the Devices file, there's now a 10
  410.      second timeout compiled in.  Make the name of the Device anything
  411.      other than "Direct".  If you tweak the example /usr/lib/uucp files
  412.      provided with SLS, you won't have problems with this one.
  413.  
  414.   o  from Greg Naber - greg@squally.halcyon.com
  415.  
  416.      If you get chat script timeouts, you can tweak the sources by
  417.      editing at line 323 in uuconf/syssub.c and changing the default
  418.      timeouts from 10 seconds to something larger.
  419.  
  420.   o  from Ed Rodda - ed@orca.wimsey.bc.ca
  421.  
  422.      If you get chat script timeouts, typically connecting to other
  423.      Taylor sites, a pause after login can fix this.
  424.  
  425.      feed Any ACU,ag 38400 5551212 ogin: \c\d "" yourname word: passwd
  426.  
  427.  
  428.  
  429.   o  from Dr. Eberhard W. Lisse - el@lisse.NA
  430.  
  431.      Some kernels experience modems hanging up after a couple of
  432.      seconds.  The following patch sent by Ian Taylor might help.
  433.  
  434.      *** conn.c.orig Mon Feb 22 20:25:24 1993
  435.      --- conn.c      Mon Feb 22 20:33:10 1993
  436.      ***************
  437.      *** 204,209 ****
  438.      --- 204,212 ----
  439.  
  440.           /* Make sure any signal reporting has been done before we set
  441.             fLog_sighup back to TRUE.  */
  442.      +   /* SMR: it seems to me if we don't care about SIGHUPS, we should clear
  443.      +      the flag before we return  */
  444.      +   afSignal[INDEXSIG_SIGHUP] = FALSE;
  445.          ulog (LOG_ERROR, (const char *) NULL);
  446.          fLog_sighup = TRUE;
  447.  
  448.  
  449.  
  450.   5.3.  Why doesn't HDB anonymous uucp seem to work ?
  451.  
  452.   The SLS anonymous uucp only works in Taylor mode because it's compiled
  453.   with HAVE_TAYLOR_CONFIG.  If you want to do anon uucp in HDB mode,
  454.   you'll have to recompile the sources with just HDB defined.  Ian
  455.   Taylor is considering which way to deal with this "feature".
  456.  
  457.   Also, Taylor in HDB mode seems to be sensitive to white space and
  458.   blank lines.  To be safe, make sure that there are no blank lines or
  459.   trailing spaces in the Permissions file.
  460.  
  461.   Lastly, make sure that you have a file called remote.unknown in
  462.   /usr/lib/uucp and that it's *NOT* executable.  See the O'Reilly+Assoc
  463.   book "Managing UUCP and USENET" for details regarding this file.
  464.  
  465.  
  466.   5.4.  What does "no matching ports found" mean ?
  467.  
  468.   In all probability, you are attempting to use a device
  469.   (/usr/lib/uucp/Devices) that doesn't exist, or the device you've
  470.   specified in the /usr/lib/uucp/Systems file doesn't match up with any
  471.   valid devices in the Devices file.
  472.  
  473.   Following this are *sanitized* versions of my working Taylor 1.05 HDB
  474.   config files that you can plug in and use.
  475.  
  476.   note the "ACU" in the Systems ?  That tells which "port" to use in
  477.   Devices
  478.  
  479.   see the "scout" word in Systems ?  That tells which dialer to use in
  480.   Dialers.
  481.  
  482.   If you had a ACU port, but none that matched the specified dialer on
  483.   the same line in Systems, you'll get that message.
  484.  
  485.  
  486.   5.5.  What are known good config files for HDB mode ?
  487.  
  488.   The following are "known-good" config files for Taylor 1.05 under
  489.   Linux in HoneyDanBer mode.  They work on kernels of 0.99-8 or later.
  490.   All files should be in /usr/lib/uucp unless you've tweaked the sources
  491.   to put the uucp library elsewhere.
  492.  
  493.   If you *HAVE* put things in non-standard places, be aware that things
  494.   like sendmail might get very confused. You need to ensure that all
  495.   communications-related programs agree on your idea of "standard"
  496.   paths.
  497.  
  498.   If you're running a kernel of 0.99-7 or earlier, change "cua1" to
  499.   "ttyS1".
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.   #------------- Devices -------------
  530.   # make sure the device (cua1 here) matches your system
  531.   # cua1 = COM2
  532.   #
  533.   # here "scout" is the Digicom Scout Plus 19.2 modem I use
  534.   # tbfast etc. is for a Telebit Trailblazer Plus modem's various speeds
  535.   #
  536.   ACU cua1 - 19200 scout
  537.   ACU cua1 - 9600 tbfast
  538.   ACU cua1 - 1200 tbslow
  539.   ACU cua1 - 2400 tbmed
  540.  
  541.   #------------- dialers --------------
  542.   # note the setting of the Trailblazer registers "on the fly"
  543.   # "scout" is a Digicom Scout Plus (Hayes-like) modem I use here
  544.   #
  545.   scout   =W-,    "" ATM0DT\T CONNECT
  546.   tbfast  =W-,    "" A\pA\pA\pT OK ATS50=255DT\T CONNECT\sFAST
  547.   tbslow  =W-,    "" A\pA\pA\pT OK ATS50=2DT\T CONNECT\s1200
  548.   tbmed   =W-,    "" A\pA\pA\pT OK ATS50=3DT\T CONNECT\s2400
  549.  
  550.   #-------------- Systems -------------
  551.   # this is a very generic entry that will work for most systems
  552.   #
  553.   # the Any;1 means that you can call once per minute with using -f (force)
  554.   # the ACU,g means force "g" protocol rather than Taylor's default "i"
  555.   #
  556.   fredsys Any;1 ACU,g 19200 scout5555555 "" \r ogin:--ogin: uanon word: uanon
  557.  
  558.   #-------------------------------- Permissions -------------------------
  559.  
  560.   # Taylor UUCP in HDB mode appears to be sensitive to blank lines.
  561.   # Make sure all Permissions lines are real or commented out.
  562.   #
  563.   # this is a anonymous uucp entry
  564.   #
  565.   LOGNAME=nuucp MACHINE=OTHER \
  566.   READ=/usr/spool/uucp/nuucp \
  567.   WRITE=/usr/spool/uucp/nuucp \
  568.   SENDFILES=yes REQUEST=yes \
  569.   COMMANDS=/bin/rmail
  570.   #
  571.   # this is a normal setup for a remote system that talks to us
  572.   # note the absolute path to rnews since this site puts things
  573.   # in locations that aren't "standard"
  574.   #
  575.   LOGNAME=fredsys MACHINE=fredsys \
  576.   READ=/usr/spool/uucp/fredsys:/usr/spool/uucp/uucppublic:/files \
  577.   WRITE=/usr/spool/uucp/fredsys:/usr/spool/uucppublic \
  578.   SENDFILES=yes REQUEST=yes \
  579.   COMMANDS=/bin/rmail:/usr/local/lib/news/bin/rnews
  580.   #----------------------------------------------------------------------
  581.  
  582.  
  583.  
  584.   5.6.  Getting uucico to call alternate numbers
  585.  
  586.   The new v1.05 has an added '-z' switch to uucico that will try
  587.   alternate numbers for a remote system.
  588.  
  589.   6.  Acknowledgements
  590.  
  591.  
  592.   The following people have helped in the assembly of the information
  593.   (and experience) that helped make this document possible:
  594.  
  595.   Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh, Pierre
  596.   Beyssac
  597.  
  598.   If I forgot anybody, my apologies.
  599.